home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / qbbs / sx300h1.zip / ADDENDUM.DOC next >
Text File  |  1992-09-08  |  16KB  |  382 lines
  1.                   Silver Xpress Mail System Addendum File
  2.              (c) copyright 1988-1992 by Santronics Software
  3.  
  4. This document contains last minutes changes and extra information possibly
  5. excluded in the official documentation.
  6.  
  7. A.1  Calling XPMAIL from the BBS
  8. A.2  Miscellaneous Display Files in the MISC directory.
  9. A.3  Silver Xpress and Communications
  10. A.4  How Baud Rates Are Used in Silver Xpress
  11. A.5  What is XPRENUM? And who should use it?
  12. A.6  About about SuperBBS BBS?
  13. A.7  About about TAG BBS?
  14.  
  15.  
  16. A.1 Calling XPMAIL from the BBS
  17.  
  18. The Silver Xpress Mail System main program is XPMAIL.EXE. You should call
  19. this program using a batch file. XPRESS.BAT is provided to serve as an
  20. example (XPRESS for PCBOARD).
  21.  
  22. The file CALLXP.ZIP contains example BBS system files to call XPRESS.BAT
  23. using BBS proper switches. (PCBOARD and RBBS do not have this file. They do
  24. not need it).
  25.  
  26. Sample call to XPMAIL:
  27.  
  28.         C:
  29.         CD \XPRESS
  30.         XPMAIL  [switches]
  31.         CD \BBS
  32.  
  33. PCBOARD has a different type of logic for calling a DOOR program. Use the
  34. XPRESS file provided. It should be all you need. Just add the proper line
  35. to the DOORS.LST file making sure the USERS.SYS file is created for Xpress.
  36.  
  37.  
  38. A.2 Miscellaneous Display Files in the MISC directory.
  39.  
  40. The following is the list of default display files shown to the user during
  41. various points of Xpress. Some of these files required the VCC compiler to
  42. create files with XPV extensions.
  43.  
  44.    WELCOME  ANS   Welcome screen shown with ANSI on.
  45.    WELCOME  TXT   Welcome screen shown with ANSI off.
  46.    WELCOME  GX    Welcome screen shown with GX menus enabled.
  47.    REGISTER TXT   Registration information shown to non-registered users.
  48.    NEWS     XPV   News information shown during when logging into XpMAIL.
  49.    NEWS     VCC   Source file to NEWS.XPV
  50.    NEWUSER  XPV   If the user is new to Xpress, this file will be shown.
  51.    NEWUSER  VCC   Source File to NEWUSER.VCC
  52.    GOODBYE  TXT   File shown when hangup from XPMAIL
  53.    GOODBYE  GX    File shown when hangup from XPMAIL with GX menus enabled.
  54.    XPVSAVER TXT   File shown when user enabled VACATION SAVER.
  55.    EXIT     TXT   File shown when exits from XPMAIL
  56.    EXIT     GX    File shown when exits from XPMAIL with GX menus enabled.
  57.    BADXPRV  TXT   File shown to user when using old version of Reader.
  58.    BADXPRV  GX    GX menu version of BADXPRV.TXT
  59.    GOLDXP   XPV   File shown when user enables GX menus
  60.    GOLDXP   VCC   Source to GOLDXP.XPV
  61.  
  62. To compile a VCC file, use  the VCC.EXE compiler. i.e,
  63.  
  64.    VCC XPVSAVER
  65.  
  66. The logic XPMAIL will use to display these files is as follows:
  67.  
  68.    1) If the file does not exist, XPMAIL will skip the display. If the
  69.       file is a XPV file, XPMAIL will display a local console error
  70.       message.
  71.  
  72.    2) If the file is NOT a XPV type, XPMAIL will use the following order
  73.       to look for the file:
  74.  
  75.         ANSI ON:    Look for file with ANS extension. Fall back to TXT.
  76.         ANSI OFF:   Look for file with TXT extension.
  77.         GX MENUS:   Look for file with GX extension.
  78.  
  79. You should modify the XPVSAVER file if you intend to provide VACATION
  80. SAVER service to your users.  Tell them when your events occur and when
  81. to pick up the mail.
  82.  
  83.  
  84. A.3 Silver Xpress and Communications
  85.  
  86. Silver Xpress supports two types of communications:
  87.  
  88.         Direct Communications
  89.         Fossil Communications
  90.  
  91. Fossil Communications is generally use with bulletin board systems such as
  92. OPUS, Maximus, Remote Access and QuickBBS. PCBOARD supports only direct
  93. communications. RBBS supports both.
  94.  
  95. With Silver Xpress, you have the option to use one or the other but not
  96. both at the same time. If you use the fossil, you must have a license (free
  97. or paid) to use fossil protocols such as X00 by Ray Quinn, or BNU by David
  98. Nugent.   Santronics Software does not distribute X00 or BNU with Silver
  99. Xpress Mail System, however, we do make it available on our support BBS.
  100. Silver Xpress will follow any fossil protocol which support the Standard
  101. Fossil Communication Specification defined in FTSC.
  102.  
  103.  
  104. Direct Communications
  105. ---------------------
  106.  
  107. When using direct communications, com ports 1 thru 8 are supported.
  108.  
  109. Direct communications will not work beyond com port #8.
  110.  
  111. If you are using irregular com port or UART settings, you can edit the file
  112. called XMT.CFG to define the new UART settings. This file is also used by
  113. XMT.EXE.
  114.  
  115. To change the UART settings, modify the file XMT.CFG using a normal text-
  116. based editor.
  117.  
  118. Fossil Communications
  119. ---------------------
  120.  
  121. When using fossil communications, XPMAIL will not impose a com port limit.
  122. It is based on what what your particular fossil supports.  In addition,
  123. irregular UART settings are completed defined by the fossil as well so
  124. there is not need to edit XMT.CFG unless XMT is used in direct
  125. communication mode.
  126.  
  127. Silver Xpress will by default define the FOSSIL for XPMAIL during
  128. installation.  This is true for OPUS, MAXIMUS, QBBS, and REMOTE ACCESS which
  129. require the fossil to operate.
  130.  
  131. You can also force FOSSIL usage by using the -F switch.
  132.  
  133. The only advantage we see by sticking with the FOSSIL with XPMAIL is that
  134. fossil with handle all flow control and buffering that is necessary.
  135.  
  136. Flow Control
  137. ------------
  138.  
  139. Silver Xpress has 3 types of flow controls:
  140.  
  141.    Transmit XON/XOFF flow control
  142.    Receive  XON/OFF  flow control
  143.    HardWare RTS/CTS  flow control
  144.  
  145. You can set these in XPADM or use the switches:
  146.  
  147.   -FTX         Enable transmit xon
  148.   -FRX         Enable receive xon
  149.   -FHW         Enable hardware flow control
  150.  
  151. All transmit XON/XOFF and Hardware flow control should always be enabled.
  152. Receive XON/XOFF is optional but it is recommended that you keep it on.
  153. It won't hurt anything in Xpress.
  154.  
  155.  
  156. A.4 How Baud Rates Are Used in Silver Xpress
  157.  
  158. Silver Xpress, ideally, would love to have both the pc-modem lock baud rate
  159. and the actual user connect baud rate whenever possible.
  160.  
  161. The Silver Xpress Mail System, as a door program, does not do anything with
  162. the comm port as far as baud rates are concern. These values are only used
  163. for information display purposes and to estimate mail transfer times.
  164.  
  165. The user baud rate is used to calculate the "approximate transfer time"
  166. after the mail scan and packing is completed.  The user baud rate and lock
  167. baud rate can be optionally passed to an external file transfer program.
  168. See the XPPROT.CTL file.
  169.  
  170. If you are using DSZ or XMT, by passing the lock baud rate and the user
  171. baud rate, these programs will display file transfer efficiency
  172. calculations during the file transfer.  Note: if a locked baud rate is not
  173. passed to XMT, XMT will determine the lock rate automatically by checking
  174. the UART.
  175.  
  176. How does XPMAIL get the baud rates in the first place?
  177.  
  178. Each BBS is different and only with newer BBS systems do they provide both
  179. values.  If available, Silver Xpress has been optimized to get these baud
  180. rates from the DOOR INTERFACE files the BBS system creates.
  181.  
  182. Below is a table summary on how XPMAIL retrieves the lock baud rate and the
  183. user baud rate when XPMAIL starts it's initialization process.
  184.  
  185. If there is any question how a BBS is passing baud rates to door interface
  186. files, to insure XPMAIL gets the information, you can use the -LB and -B
  187. switches.
  188.  
  189.   -Bxxxx            - where xxxx is user connect baud rate.
  190.   -LBxxxx           - where xxxx is the lock baud rate.
  191.  
  192. These switches will override how Xpress gets it's baud rate from the door
  193. interface files shown below. It will guarantee Silver Xpress will know how
  194. to calculate transmission times and properly pass this information to
  195. outside transfer programs.
  196.  
  197.  
  198.     BBS MODEL             LOCKED BAUD          USER BAUD
  199.     ---------------------------------------------------------------
  200.  
  201.     OPUS 1.03             DEFINE IN XPADM      LASTUSxx.BBS FILE
  202.  
  203.     OPUS 1.10             DEFINE IN XPADM      LASTUSxx.DAT FILE
  204.                           Taken From BBS.PRM
  205.                           during Install
  206.  
  207.     OPUS 1.7x             DEFINE IN XPADM      LASTUSxx.DAT FILE
  208.                           Taken From BBS.PRM
  209.                           during Install
  210.  
  211.     MAX  2.00             DEFINE IN XPADM      LASTUSxx.BBS FILE
  212.                           Taken From BBS.PRM
  213.                           during Install
  214.  
  215.     PCBOARD               PCBOARD.SYS          PCBOARD.SYS
  216.  
  217.     RBBS                  DORINFOxx.DEF        MAIN MESSAGE BASE
  218.                                                CHECK POINT RECORD
  219.  
  220.     RBBS (NON RBBS BBS)   DORINFOxx.DEF        USE -B SWITCH
  221.  
  222.     HMS                   DEFINE IN XPADM      EXITINFO.BBS
  223.                           Taken From BBS
  224.                           CONFIG file during
  225.                           Install
  226.  
  227.  
  228. For BBS systems where the lock baud rate is not being passed by a door
  229. interface file, you might be better off using the -LB switch. This is
  230. particularly true for multi-line situations. If the lock baud is different
  231. from node to node, use the -LB for each XPMAIL.EXE node.
  232.  
  233.  
  234. A.5  What is XPRENUM? And who should use it?
  235.  
  236. XPRENUM is a FIDO-BASED message (*.MSG) renumbering system.
  237.  
  238. This program is provided as a utility for sysops using Silver Xpress models
  239. F1, P1, and R1.  Any other models do not require it, however you can still
  240. use this program as a replacement of your current renumber utility.
  241.  
  242. F1 is the OPUS 1.03 model of Xpress. OPUS 1.03 does not HAVE a last read
  243. pointer system for users. So by using XPRENUM, you will ensure a proper
  244. last read pointer system for Xpress.
  245.  
  246. P1 and R1 are the PCBOARD and RBBS models of Xpress. If you are using any
  247. of the models for FIDO-BASED message areas where you are not converting
  248. from a FIDO mail format to the BBS mail format, then you should use the
  249. XPRENUM to ensure a proper last read pointer system for these FIDO message
  250. areas.
  251.  
  252. XPRENUM program is a simple, but very fast, renumber system for fido
  253. (*.msg) mail areas only.
  254.  
  255. XPRENUM will maintain a file called XPLREAD.IDX for each FIDO area. XPMAIL
  256. will look for this file for the user's last read pointer.
  257.  
  258. XPRENUM will adjust the Silver Xpress last read pointer file located in
  259. each fido area (XPLREAD.IDX).  The program should be run in place of your
  260. current Fido Base message renumbering program.
  261.  
  262. You should run XPRENUM during your MAIL events.  The following is a
  263. summary of the XPRENUM command line switches:
  264.  
  265. Parameters   Description
  266. ------------------------------------------------------------------------
  267. -V         : view renumbering/relink process
  268. -R         : perform a renumbering/relink process. Update XPLREAD.IDX
  269. -N #1 #2   : Save first #, and Keep the LAST # msgs and delete the rest.
  270. -S         : Update the FIDO LASTREAD file as well if -R is used.
  271. -O170      : Update the OPUS 1.70 LREAD.DAT file as well if -R is used.
  272. -M102      : Update the Maximus 1.02 LASTREAD.BBS file as well if -R is used.
  273. msg_path   : directory location of fido area. Must be last on cmd line.
  274.  
  275. WARNING!
  276.  
  277. Not using this program will guarantee FAILURE of keeping up-to-date last
  278. read pointers for fido areas.  Silver Xpress version F1 requires this
  279. program.  Silver Xpress model P1 and R1 require this program if and only if
  280. you are integrating pure FIDO areas into your BBS setup.
  281.  
  282. Examples:
  283.  
  284.       xprenum -R -N 1 30 e:\msg\net
  285.       xprenum -R -n 1 50 e:\msg\xpress
  286.       xprenum -S -R -n 1 50 e:\msg\xpress
  287.       xprenum -S -R -O170 -n 1 50 e:\msg\xpress
  288.       xprenum -S -R -M102 -n 1 50 e:\msg\xpress
  289.  
  290.  
  291. A.6  About about SuperBBS BBS?
  292.  
  293. Silver Xpress Model H1 (HMS Xpress as we called it) will support any HMS
  294. based BBS.  The H1 model will directly support:
  295.  
  296.         Remote Access 1.xx
  297.         QuickBBS 2.7x
  298.         QuickBBS 2.64
  299.  
  300. If you wish to support SuperBBS, you must use conversion tools which
  301. convert the SuperBBS system files into one of the above formats. As of
  302. today, these conversion tools exist for SuperBBS to QuickBBS 2.64 format.
  303.  
  304. XPADM will prompt you to select the version you want to install. Choose
  305. QuickBBS 2.64 but you must have the QuickBBS 2.64 files around to be
  306. successful.
  307.  
  308. We do plan direct support of SuperBBS. But we also need your support as
  309. well. To will ensure that we speed up the development process.
  310.  
  311.  
  312. A.7  About about TAG BBS?
  313.  
  314. TAG BBS can use the RBBS version of Xpress or the HMS version of Xpress.
  315.  
  316. RBBS Xpress support Fido Areas so if only want fido areas, RBBS Xpress is
  317. the right way to go.  Download this file called XPR1TAG.ZIP by Rick Cooper.
  318.  
  319.  XPR1TAG.ZIP  - Explains how to install the RBBS Model of Xpress with TAG.
  320.                 As of this writing, the only thing you will have to change,
  321.                 based on what I saw, are his references to the XPMAIL
  322.                 switches in the example batch file. They have CHANGED!!!!
  323.                 See the WHATSNEWS.300 for a summary of command line
  324.                 switches.
  325.  
  326. If you want to support HMS areas, then you can use the H1 model of Xpress.
  327. A few TAG/Xpress packages have been put together to assist in the
  328. integration process.
  329.  
  330. The following was put together by Tom Schwarz.
  331.  
  332. In order to use Xpress with TAG you will have to download the HMS version
  333. of Xpress if you are using the Hudson message bases.  This doc file
  334. describes how to use Xpress with Tag's Hudson message bases only!
  335.  
  336. After you download this file you will also need a file called HMSTOOLS.ZIP.
  337. This file has a program that converts from a DOOR.SYS type file to an
  338. EXITINFO.BBS type file.  Xpress needs the EXITINFO.BBS file and as I could
  339. find no way to make one I had Hector write up this short program.  It is
  340. called DSYS2EI.EXE and takes one parameter, the location of the DOOR.SYS
  341. file as shown in the example below. The only other utilitiy you will need
  342. is the QCONFIG program from the QBBS system.  This allows you to make up
  343. the CONFIG.BBS file that Xpress needs.  You can download this file from CIS
  344. or probably any of the other online services or from you local QBBS system.
  345. After you set up your message areas in the QCONFIG program you will be
  346. almost all done.  Put the batch file at the end of this document in your
  347. BBS directory and then add the command to your menus using the following
  348. parameters:
  349.  
  350. PKey: =
  351. Command: *XPRESS.BAT
  352.  
  353. You can set all the other options for the command to anything you want.  If
  354. you have any questions on this please leave a message on Hectors board and 
  355. I will check in from time to time to help anyone out that might be having a
  356. problem.  If you need help quickly Hector knows how to get in touch with me
  357. right away.  Hope this doc file helps you out.  The only other thing is follow
  358. Hectors configuration program allowing and you should have no trouble.
  359.  
  360. Thomas Schwarz
  361.  
  362. Here's a sample XPRESS.BAT file for all of you.  Hope this helps...
  363.  
  364. --XPRESS.BAT---
  365.  
  366.    @ECHO OFF
  367.    DSYS2EI.EXE C:\BBS\DOOR.SYS
  368.    cd \xpress
  369.    xpmail -LB19200 -P1 -F -FCTS -TS -NU -A%2
  370.    cd \qmail
  371.    if exist f:\msgs\echotoss.log qm scan pack netmail_scan
  372.    if exist F:\QMAIL\ECHOMAIL.BBS QM SCAN PACK NETMAIL_SCAN
  373.    if exist F:\QMAIL\NETMAIL.BBS QM SCAN PACK NETMAIL_SCAN
  374.    ERASE F:\QMAIL\ECHOMAIL.BBS
  375.    ERASE F:\QMAIL\NETMAIL.BBS
  376.  
  377.  
  378. EDITOR NOTE: Rick Cooper at 1:236/16 is almost complete with a complete
  379. TAG/XPress interface system so that you don't need the QBBS Qconfig.exe
  380. program.  It should be done by the end of September 92.
  381.  
  382.